Additional APIs

---

In this release are additional APIs to allow application programs to get SAM-FS data in a consistent way that will not change across releases. New library calls in this release:

1. sam_cancelstage() This new API call gives an application the means to cancel a pending or in-progress stage on a file, supplying the file name.
2. sam_stat() The sam_stat structure and library call have been updated to return flags indicating that a stage is pending or in-progress on the file and whether an error occurred on the last attempt to stage the file.
3. catalog APIs sam_opencat(), sam_getcatalog(), and sam_closecat(). These new APIs provide a means for an application to open and read the catalog for a media library. The catalog file name is specified for opening the catalog, and a range of library slot numbers is specified to obtain the catalog entries. The application can have multiple catalog files open simultaneously.

See the man pages sam_cancelstage(3), sam_state(3) sam_opencat(3), sam_getcatalog(3) and sam_closecat(3) for more details.

---

For more information, send us mail inform@lsci.com.